home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / source / thesource6.dms / thesource6.adf / Source / Compression / hcompress.lha / hcompress / vms / aareadme next >
Encoding:
Text File  |  1992-04-22  |  3.0 KB  |  66 lines
  1.         Installation instructions for HCOMPRESS on VMS machines
  2.                     R. L. White, 20 April 1992
  3.  
  4. This directory contains DCL command files for building HCOMPRESS on a VMS
  5. machine (VAX) and some DCL command files that make using the programs a little
  6. easier.
  7.  
  8. Steps for installation:
  9.  
  10. (1) Copy the contents the contents of this directory into the
  11.     source directory.
  12. (2) Do "@MAKE" to compile and link the programs.
  13. (3) Run "@HCOMPINIT" to define symbols for the compression and
  14.     decompression programs.  You can of course include this in
  15.     your LOGIN.COM file so that the symbols get defined whenever
  16.     you login.  The programs can be installed in some public location
  17.     by your system manager if they are going to be used by other
  18.     users on your computer.
  19. (4) Instructions for using these programs are in the doc directory
  20.     in the files hcompress.ps (Postscript file) and hcompress.man
  21.     (plain text file).
  22.  
  23. Now the programs should be ready to run.  You may want to customize
  24. the command files for your applications.  Some possible changes to
  25. consider:
  26.  
  27. (1) There are command files to compress multiple files in FITS format
  28.     and in hhh/hhd format.  If you usually use some other formats you
  29.     could include in the script a conversion from your format to
  30.     one of the accepted formats.
  31. (2) The amount of compression is determined by the scale factor, set by
  32.     the -s option in the programs.  For astronomical images the compression
  33.     is generally limited by the amount of noise in the images and the
  34.     scale factor should be about 2 times the RMS noise in the image.
  35.     For noiseless images any non-zero scale factor will give up some
  36.     information, so the choice of scale factor will be determined by how
  37.     much you are willing to lose.  A default scale factor of 666 is used
  38.     in the scripts -- this should probably be changed to a value appropriate
  39.     for your typical images.  If you like, you could set this default to 0
  40.     (lossless compression.)
  41. (3) The MODIFY program can be used to change the format of the decompressed
  42.     images from the default STREAMLF to FIXED record format.  This may
  43.     be necessary if programs you use to read the image require the file
  44.     to be in a particular format.  The usage is
  45.         
  46.         MODIFY FILENAME [ blksiz ]
  47.  
  48.     The default for blksiz is 512 bytes.  As written by C, the file
  49.     has the following attributes:
  50.  
  51.         Record format:      Stream_LF
  52.         Record attributes:  Carriage return carriage control
  53.  
  54.     After being modified, it is:
  55.  
  56.         Record format:      Fixed length <blksiz> byte records
  57.         Record attributes:  None
  58.  
  59.     MODIFY does not copy the file; instead, it simply modifies the
  60.     RMS header of the file using a VMS utility, SYS$MODIFY.
  61.     Unfortunately, SYS$MODIFY is unsupported (and undocumented), so
  62.     it may fail to work with some future upgrades to the VMS
  63.     operating system.  Suggestions for a better way to make this
  64.     file modifications (short of major changes to the hcompress
  65.     source code) are welcome.
  66.